home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 034a / cam_m100.zip / INSTALL.DOC < prev    next >
Text File  |  1991-11-19  |  14KB  |  330 lines
  1. *******************************************************************************
  2. IMPORTANT:  SHARE.EXE must be loaded to run CAM-MAIL.  If you do not have SHARE
  3.             loaded the door will LOCK up when Uploading a .REP file.
  4. *******************************************************************************
  5.  
  6.           DISCLAIMER
  7.           ----------
  8.  
  9.           This software is provided without any guarantee, either expressed
  10.           or implied.  All responsibilities for its use rest with the user
  11.           of the software and not the author. 
  12.  
  13.           Cam-Mail software and this document is (C) Copyright 1991 Cam N.
  14.           DeBuck.  All rights reserved World Wide.
  15.  
  16.           License
  17.           -------
  18.  
  19.           Cam-Mail is not in the Public Domain.  Cam-Mail is not free.
  20.  
  21.           Non-registered users are granted a limited, 30-day license to
  22.           determine whether or not the program meets their needs. 
  23.           Continued use of Cam-Mail beyond the 30-day evaluation time
  24.           period requires registration of the program.  Use of non-
  25.           registered copies of Cam-Mail beyond the original evaluation
  26.           period is strictly prohibited.
  27.  
  28.           No one may modify Cam-Mail for any reason, in any way, including
  29.           but not limited to, decompiling-compiling, patching,
  30.           disassembling, or reverse engineering the program.
  31.  
  32.           Cam-Mail may be copied and distributed to others, subject to the
  33.           above restrictions and the following:
  34.  
  35.                Cam-Mail must be copied in unmodified form, including the
  36.                file containing this license information.
  37.  
  38.                Complete Cam-Mail documentation and Online Help must be
  39.                included.
  40.  
  41.                No copying fee of any type may be assessed other than basic
  42.                charges for the cost of the copying medium.
  43.  
  44.                Cam-Mail may not be distributed with any other software or
  45.                hardware product(s) without the express written permission
  46.                of the author, Cam N. DeBuck.
  47.  
  48.           Sysops (bulletin board SYStem OPerators) may make Cam-Mail
  49.           available for downloading by their users as long as all above
  50.           conditions are met.
  51.  
  52.           Commercial Distributors of Public Domain, ShareWare, or User-
  53.           Supported software may distribute Cam-Mail subject to the above
  54.           conditions only after obtaining specific written permission from
  55.           the author, Cam N. DeBuck and filling out a registration form for
  56.           upgrade notifications.  This condition supersedes any and all
  57.           previous agreements.
  58.  
  59.  
  60.                     Cam-Mail v1.0 Installation Documentation
  61.  
  62.      First, let's make this short and simply.  Follow the instructions
  63. to a tee and nothing can go wrong:
  64.  
  65. 1)  Take *ALL* nodes down.
  66. 2)  Go into your PCB directory and run PCBSM.EXE
  67. 3)  Go into D User Info File Maintenance
  68. 4)  Go into C Add/Update Third Party Application
  69. 5)  Enter Name of Third Party Application ? CAM-MAIL
  70. 6)       Version: 1
  71. 7)   Static Size: 60
  72. 8)  Dynamic Size: 1
  73. 9)       KeyWord: MAIL
  74. 10) Press PGDN to begin!
  75.  
  76. 11) At this point you can bring up all your nodes if you would like.
  77. 12) Go into your PCB directory and run PCBSETUP.EXE.
  78. 13) Edit your DOORS.LST file in which conference you have your doors in
  79.     and add the door by the name of:  MAIL  (Create USERS.SYS is Yes)
  80.  
  81. 14) That's it for the PCBoard side of the installation.  Now let's go install
  82.     the door itself:
  83.  
  84. 15) Create a directory called:  \CAM-MAIL  (I suggest from the root directory,
  85.     but it not necessary).  All defaults are setup using the directory
  86.     \CAM-MAIL.
  87.  
  88. 16) Change to the directory you just created and unzip the CAM-M1Bx.ZIP file
  89.     or the START.ZIP file (The actual filename will vary depending on which
  90.     version you have or where you got it from).
  91.  
  92. 17) Create several directories called:
  93.        \CAM-MAIL\FILES
  94.        \CAM-MAIL\BLTS
  95.        \CAM-MAIL\HELP
  96.        \CAM-MAIL\OFFLINE
  97.  
  98.     Or if you prefer to use different paths, the CMSM will create the new
  99.     paths for you after editing the fields.
  100.  
  101. 18) Run CMSM.EXE and go into E Misc Paths
  102. 19) Change the Paths if Necessary and select the Work Drive.
  103.     Be sure CMSM asks you to create the directories to avoid any problems.
  104.  
  105. 20) Select C Download Limits
  106. 21) First, a tidbit of information.  As of this writing most Off-Line
  107.     Readers only allow 200 messages per conference.  Please keep that in
  108.     mind when selecting the number of messages per conference.
  109.  
  110.     However, for NetMail Systems, you can have as many messages as possible.
  111.  
  112. 22) It is up to you that you select the number of messages the user can
  113.     download per conference and per QWK Packet (Total Messages).
  114.     I personally believe that you should set the number of messages per
  115.     conference to 200 for each Connect Rate.  However, this is what I suggest
  116.     for the Total Number of Messages per packet:
  117.  
  118.      Connect Rate      Msgs Per Conf    Msgs Per Packet
  119.      ------------      -------------    ---------------
  120.               300                200                200
  121.              1200                200                400
  122.              2400                200                600
  123.              4800                200                800
  124.              9600                200               1000
  125.             14400                200               1000
  126.  
  127. 23) If you have any special security levels (Such as friends or NetMail
  128.     systems) you will probably want to use the Security Specific area for
  129.     these security levles.  The Security Specific area will override the
  130.     Default settings no matter what Baud Rate they call in at.  This comes
  131.     in very handy for Anybody that you want to give NetStatus to if you're
  132.     acting as a HUB.  This way you won't have to go into the this program
  133.     to update their NetStatus flag (The door will automatically do it for
  134.     you).  I have no suggestions for any numbers in this area as it will
  135.     vary for each BBS System.
  136.  
  137. 24) Number of *.QWK's for Upload Credit?  Use this area if you wish to give
  138.     users upload credits for upload QWK packets.
  139.  
  140. ***  Anything beyond this point is optional and may not be required.
  141.  
  142. Bulletin Scanning
  143. -----------------
  144. NOTE: CMSM.EXE creates a file (If you have bulletins scanned for a particular
  145.       conference) called CAMBxxx (where xxx is the conference number).  I had
  146.       a slight problem previously with people having the same names for their
  147.       actual bulletin names.  Be sure you don't have this problem by using a
  148.       different path to the Bulletin Files (I suggest the CAM-MAIL directory).
  149.  
  150. 25) Go into A Bulletin Scanning.  Please note, depending on the number of
  151.     conferences that you have, it might take a little bit for CMSM to setup
  152.     the conference information for the bulletins.
  153.  
  154.  
  155. 26) Select a Conference(s) that you wish to have Bulletins Scanned and hit
  156.     return.
  157.  
  158.       A) Another menu will pop up on the side if you have any bulletins in
  159.          this conference.
  160.       B) Now select the Bulletins you want to scan for by pressing the RETURN
  161.          key. A CheckMark will appear by bulletins that you have selected.
  162.          To turn a bulletin off (After selecting one), use the RETURN key
  163.          once again.
  164.       C) In most cases you will only want to select Bulletins that are updated
  165.          on a Daily or Weekly Basis (Or monthly).
  166.       D) Use the ESC key to return back to the Conference Area.  A check mark
  167.          will appear by the conference name if you have any bulletins selected.
  168.  
  169. New Files Scanning
  170. ------------------
  171. NOTE: CMSM.EXE creates a file (If you have new files scanned for a particular
  172.       conference) called CAMFxxx (where xxx is the conference number).  I had
  173.       a slight problem previously with people having the same names for their
  174.       actual DIR files.  Be sure you don't have this problem by using a
  175.       different path to the New Files Directory (I suggest CAM-MAIL).
  176.  
  177. 27) Go into D Files Scanning.  Please note, depending on the number of
  178.     conferences that you have, it might take a little bit for CMSM to setup
  179.     the conference information for the File Listings.
  180. 28) Select a Conference(s) that you wish to have Directories Scanned and hit
  181.     return (These are your DIRxx files).
  182.  
  183.       A) Another menu will pop up on the side if you have any DIR's in
  184.          this conference.
  185.       B) Now select the DIR you want to scan for by pressing the RETURN
  186.          key. A CheckMark will appear by DIR's that you have selected.
  187.          To turn a DIRn off (After selecting one), use the RETURN key
  188.          once again.
  189.       C) In most cases you will only want to select DIR's that are updated
  190.          on a Daily or Weekly Basis (Or monthly).  This would definately
  191.          include your Upload Directory.
  192.       D) Use the ESC key to return back to the Conference Area.  A check mark
  193.          will appear by the conference name if you have any bulletins selected.
  194.  
  195. Compression
  196. -----------
  197. 29)  You can have as many as 5 different compression methods available to your
  198.      users.  At this point of writing the most dominant compression method is
  199.      PKZip.  If you are installing the door for the first time this compression
  200.      has already been setup for you (Including the necessary batch files).
  201.      Please note that Archive #1 is the default that is used for New Users.
  202.  
  203. 30)  Find an Empty Archive name and enter in a name.
  204. 31)  Now Add the Archive Letter you wish to use.
  205. 32)  At this point you will need to exit the program and create 2 batch files
  206.      by this format:
  207.  
  208.         CAMZIPx.BAT    (Where x is the Archive Letter).
  209.         CAMUZIPx.BAT   (Where x is the Archive Letter).
  210.  
  211. 33)  CAMZIPx.BAT has two parameters passed to it:
  212.  
  213.         %1 - The Path/Name of the QWK Packet
  214.         %2 - The files to be Archived.
  215.  
  216.      Sample Batch file would look like this for PKZip:
  217.  
  218.         PKZIP -es %1 %2
  219.  
  220. 34)  CAMUZIPx.BAT has three paramters passed to it:
  221.  
  222.         %1 - The Path/Name of the REP Packet
  223.         %2 - The File to be UnArchived
  224.         %3 - The Path of the WORK Directory (A trailing '\' is not included).
  225.  
  226.      Sample Batch file would look like this for PKUNZip
  227.  
  228.         PKUNZIP %1 %2 %3
  229.  
  230. 35)  That's all there is to Compresssion Area.
  231.  
  232. Internal Protocols
  233. ------------------
  234.  
  235. 36) You have the option of turning ON/OFF Internal Protocols.  I suggest
  236.     that you leave all of them on.
  237.  
  238. External Protocols
  239. ------------------
  240. 37) You can have up to 10 different External Protocols.
  241. 38) The Protocol in the Upper Left Hand corner is the default protocol for
  242.     New Users.  I suggest that you have Zmodem in this position.  If you
  243.     are installing this door for the first time Zmodem has already been
  244.     installed for you.
  245. 39) Find a Blank Protocol and Add a Protoocol Name.
  246. 40) Enter in the Protocol Letter.
  247. 41) The ARQ option should be set to YES if this protocol requires an ERROR
  248.     Correcting Modem (MNP) or such.  Protocols such as Ymodem-G and Xmodem-G
  249.     require Error Correcting Modems and have been installed as Internal
  250.     Protocols.
  251. 42) At this point you will need to exit CMSM (Save the information) and create
  252.     2 batch files by the names of:
  253.  
  254.        CAMRx.BAT  (Where x is the Protocol Letter)
  255.        CAMSx.BAT  (Where x is the Protocol Letter)
  256.  
  257.     Both of these files work exactly as PCBoard does for external Protocols.
  258.     Please see your PCBoard documentation on how to implement these.  If you
  259.     already have some PCBoard external Protocols, simply copy over your
  260.     PCBRx.BAT and PCBSx.BAT and rename them appropriately.  Cam-Mail will work
  261.     just fine with these.  In case you don't have your PCBoard manual handy
  262.     here are what each % value represents:
  263.  
  264.       %1 - Com Port Number
  265.       %2 - PC to Modem Speed (DTE)
  266.       %3 - Path/Name of File to Transfer
  267.       %4 - Connect Speed displayed by PCBoard to the Caller
  268.       %5 - Carrier Speed
  269.       %6 - Path to the WORK directory (For Bi-Directional Protocols)
  270.  
  271. 43) Now UNZIP the HELPMENU.ZIP into your HELP directory that you specified in
  272.     the CMSM.EXE program.  Be sure that you put the NEWUSER file in the proper
  273.     directory.
  274.  
  275. Cam-Mail Batch Files
  276. --------------------
  277. If you are running a Multi-Node BBS please be aware that you *MUST* make *ALL*
  278. Batch files used by Cam-Mail as READ-ONLY.  You do this by using the ATTRIB
  279. file.  Once you have everything setup go into your CAM-MAIL directory and type:
  280.  
  281.     ATRRIB +r *.BAT
  282.  
  283. This will prevent share violations on the BATCH files.
  284.  
  285.  
  286. Now all you need to do is make your MAIL batch file to load the door.  There
  287. several command line switches which need to be passed to Cam-Mail.
  288.  
  289. IMPORTANT:  You NEED to run the CAM-MAIL.EXE in the CAM-MAIL directory.  DO
  290.             NOT run it from your PCB directory.
  291.  
  292. Here is the information for the command line switches that NEED to be passed
  293. to CAM-MAIL.EXE:
  294.  
  295.   CAM-MAIL.EXE Path_To_PCB_Directory BiosWrites(YES/NO)  Optional[Work Drive Letter]
  296.  
  297. Examples:
  298.  
  299.   CAM-MAIL.EXE C:\PCB NO
  300.  
  301. This would tell Cam-Mail that your PCBoard Directory is at C:\PCB and that you
  302. do not want Bios Writes.
  303.  
  304.   CAM-MAIL.EXE C:\PCB YES G
  305.  
  306. This would tell CAm-mail that your PCBoard Direcotry is at C:\PCB and that you
  307. do want Bios Writes and that you want to override the configuration Work Drive
  308. to the G Drive.
  309.  
  310. Please note that the First TWO switches are necessary. The third one is an
  311. option.  I had some Beta Testers who had different Ram Disks on each Node so
  312. they needed a way to override the configuration work drive.
  313.  
  314.  
  315. NOTE:  There are several extra EXE files for maintaning your BBS.  These are
  316.        as follows:
  317.  
  318.          /DUPON    - Force Duplicate Checking (Be sure you run CRCSM)
  319.          /NOWINDOW - The BOX Window will be disabled for External Shells
  320.          Letter    - The RAM DRIVE Letter to use for a WORK Drive.
  321.  
  322.   These switches MUST follow the other command line switches.  Here is an
  323. example of how to use all three optional switches:
  324.  
  325.   CAM-MAIL.EXE C:\PCB NO Z /DUPON /NOWINDOW
  326.  
  327. This would use my ramdisk designated as Drive Z, force duplicate checking, and
  328. will use No Windows for external shells.
  329.  
  330.